






Apple Il =. 


lIEEE—488 Interface 


User’s Guide 














<data>, even if <data> already has a <LF> after each <CR>. The 
LINEFEED option does not affect the data sent by WRITECNT commands. 
During READ commands issued while LINEFEED is set to on, the IEEE-488 
card expects a <LF> to follow the terminating <CR>. 


The LINEFEED commands are as follows: 


1g PRINT DS;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
2¢ PRINT "LFI" (line feed character is provided after each <CR>) 
2¢ PRINT "LFG" 


(line feed character is not provided after each <CR>) 


LINEFEED is set to off when <EOS> is changed from <CR>. 


EOS: ES 


End Of String Character. The EOS command is used to change the 


character used to terminate a string. The EOS character is a <CR> 
under normal or default conditions. A reset or PR#3 instruction 


resets the EOS character to <CR> . LINEFEED is set to off when <EOS> 
is changed from <CR>. The EOS command is 


ES <EOS> <CR> 


The EOS command format is as follows: 


19 PRINT D$;"PR#3" :REM THE VALUE OF D$ IS <CTRL-D> 
29 PRINT "ES!" 


This command changes the EOS character from <CR> to ! 


SCREEN: SC 


Screen Control. The SCREEN command is used to control the CRT 
display during operation of the GPIB. The CRT display shows all 
input and output characters when SCREEN control is on. The display 
is very useful during program debugging. The normal (default) 
condition of SCREEN is off. The SCREEN command takes the form 


SC <off = G/on = I> <CR> 
The SCREEN command is as follows: 


10 PRINT D$;"PR#3" 


:REM THE VALUE OF D$ IS <CTRL-D> 
20 PRINT "'SC1" 


(data is displayed on the CRT display) 


20 PRINT "SCO" (data is not displayed on the CRT) 
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The DEVICE command is used to set the 

the Apple controller. The normal or default device 
Apple controller is G, and it will be reset to @ by a 
instruction, or by pressing RESET. The device number, used 


modulo 32, may be one or two ASCII decimal digits; if the mumber is 
ie er less, the Reading @ can be omitted. The device number 31 
corresponding to 31,63,95...) may not be used because it is 


reserved for the UNLISTEN and UNTALK commands. The DEVICE command 
takes the form 


DV <device number> <CR> 
The DEVICE command follows: 


19 PRINT DS$;"PR#3" 
26 =PRINT “Dvg1" 


WRITE: WT 


Write Data Out. 
<listen list>. 


:REM THE VALUE OF DS IS <CTRL-D> 


The WRITE command sends data to all devices named in 
The WRITE command is the normal way of sending data 


from the Apple to one or more remote devices. The command takes the 
form 


WT <listen list> <data> <E0S> 


An EOI (End-Or-Identify) bus signal is automatically sent with the 
last <EOS> character. A <CR> is the normal <EO0S>. If the LF flag is 
set (see the LF command), and the <E0S> character is <CR>, then EOL 
is sent with the <LF>. Sample WRITE commands follow: 


19 = D$;"PR#3": REM THE VALUE OF D§ IS <CTRL-D> 
30 PRINT "WT1"; 2$; A$ : REM THE VALUE OF Z$ IS <CTRL-Z> 


This command sends the string of data, A$, to the listener with 


address equal to the value of keyboard character 1 (49 decimal, 61 
octal or 31 hex). 


4 PRINT “WT8"; CHRS(97); 2$; A$ : REM THE VALUE OF Z§ IS <CTRL~Z? 


This command sends the string of data, A$, to the listener with 


primary address "8" and secondary address "a". The CHR$ function must 


be used to send lower-case characters such as “a” from the Apple a 
keyboard. The CHR$ functions are listed in table A-3 af Appendix . 
The ASCII code for “a" is 97, so CHR§(97) generates an a - 


Program 1 in Appendix D shows how lower case characters can be sent 
from Integer BASIC. 
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COMMAND FORMAT 


WRITE WT <listen list> <data> <£0S> 


WRITECNT WC <listen list> <count> <data> 

RD <talker> <CTRL-Z> <data> <term> 

RC <talker> <CTRL-Z> <count> <data> <term> 

XF <talker> <CTRL-Z> <listen list> <CR> 

TG <listen list> <CR> 

CA <CR> 

CL <listen list> <CR> 

RA <CR> 

RM <listen list> <CR> 
LL <CR> 

LOCAL LA <CR> 


LOCDV LO <listen list> <CR> 


SRQD SR <srq> <CR> 


SPOLL SP <talker> <CTRL-Z> <status word> <CR> 


PPOLL PP <status word> <CR> 


PPENB PE <enable list> <CR> 


PPDIS PD <listen list> <CR> 
PPUAL PU <CR> 

ABORT AB <CR> 

LINEFEED LF <off/on> <CR> 
EOS ES <E0S> <CR> 
SCREEN SC <off/on> <CR> 
DEVICE DV <device number> 


UNTALK UT <CR> 


> 
a) 
<a 
a) 
tm 
tu 
ia 
Ka 
eu 
a 
es bal 
es 
= 
aa cat 
Ss 
cane 
aes 
cae 
Ea 
came 
es 
ae 
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<list i:= 
en list> :: <CTRL-Z> | <listener> <CTRL-Z> | <listener> listen list> 


<lis i= 
tener> :; <primary listener> | <primary listener> <secondary address> 


<primary listener> ::= <sSP> tl Re Ay eee. >be 


“secondary address> ::= * | a | b [Ci Jem ay 


=- nerinal digit> <CTRL-z> | <decimal digit> <count> 
OTE: The maximum total value for count is 255. 


<count> :: 


<EOS> ::= any ASCII character 
empty | amy ASCII character | any ASCII character <data> 


<data> ::= 
<talker> ::= empty | <primary talker> | <primary talker> <secondary address> 


<primary talker> ::= @|{A{Bi{C...~ | 


OO ll 2 leet Bs sae 


Shex digit> :: 


<decimal digit> om 10 Will db aes 9. 


tz= <hex digit> <hex digit> 


<status word> 
<srq> <::= ASCII "T" | ASCII "F" 


<term> ::= empty | <CR> | <EOS> | EOI 
NOTE: empty if last char = <CR> or <CR><LF> 


<decimal digit> <decimal digit> 
NOTE: Maximum device number is 30 


i: 


<device number> 


ASCII "O" | ASCII "1" 
tt= <listener> <enable> | <listener> <enable> <enable list> 


<off/on> =: 


<enable list> 
@ {Al Beoe NJ O 


<enable> : 


ASCII carriage return (13 decimal) 
ASCII linefeed (10 decimal) 
ASCII space (32 decimal) 
(26 decimal) 


:= ASCII SUB 
(4 decimal) 


<CTRL-Z> 


ASCII ET 


<CTRL-D> 
* NOTE: Marked elements are ASCII characters. 
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NOTICE 
Apple Computer, Inc. reserves the right to make improvements in the 
product described in this manual at any time and without notice. 
DISCLAIMER OF ALL WARRANTIES AND LIABILITY ae nT tee ee | 
APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, 
WITH RESPECT TO THIS MANUAL OR WITH RESPECT TO THE SOFTWARE DESCRIBED : 
IN THIS MANUAL, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS 
APPLE COMPUTER, INC. SOFTWARE IS SOLD 
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FOR ANY PARTICULAR PURPOSE. 
OR LICENSED "AS IS". THE ENTIRE RISK AS TO ITS QUALITY AND 
PERFORMANCE IS WITH THE BUYER. SHOULD THE PROGRAMS PROVE DEFECTIVE 
FOLLOWING THEIR PURCHASE, THE BUYER (AND NOT APPLE COMPUTER, INC. 


ITS DISTRIBUTOR, OR ITS RETAILER) ASSUMES THE ENTIRE COST OF ALL 
BE 


NECESSARY SERVICING, REPAIR, OR CORRECTION AND ANY INCIDENTAL OR 
CONSEQUENTIAL DAMAGES. IN NO EVENT WILL APPLE COMPUTER, INC. 
LIABLE FOR DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES 
RESULTING FROM ANY DEFECT IN THE SOFTWARE, EVEN IF APPLE COMPUTER, 
INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME 
STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES 
OR LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 


LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 
All 


This manual is copyrighted and contains proprietary information. 
rights are reserved. This document may not, in whole or in part, be 
copied, photocopied, reproduced, translated, or reduced to any 
electronic medium or machine-readable form without prior consent, in 
writing, from Apple Computer, Inc. 


Inc. 


©1981 by Apple Computer, 
19269 Bandley Drive 
Cupertino, California 95914 


(498) 996-1919 
The word APPLE and the Apple logo are registered trademarks of 


APPLE COMPUTER INC. 


APPLE product #A2L9937 
(030-0197-A) 


PLEASE READ THIS MANUAL BEFORE ATTEMPTING TO INSTALL THE APPLE IL 
IEEE-488 INTERFACE CARD IN THE APPLE COMPUTER. INCORRECT 


INSTALLATION COULD CAUSE PERMANENT DAMAGE TO BOTH THE INTERFACE CARD 


AND TO THE APPLE. 
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